home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / gltexcoord.z / gltexcoord
Encoding:
Text File  |  2002-10-03  |  12.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111dddd,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ffff,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111iiii,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ssss,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222dddd,,,,
  10.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ffff,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222iiii,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ssss,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333dddd,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ffff,,,,
  11.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333iiii,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ssss,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444dddd,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ffff,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444iiii,,,,
  12.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ssss,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ddddvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ffffvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111iiiivvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ssssvvvv,,,,
  13.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ddddvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ffffvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222iiiivvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ssssvvvv,,,,
  14.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ddddvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ffffvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333iiiivvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ssssvvvv,,,,
  15.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ddddvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ffffvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444iiiivvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ssssvvvv - set the
  16.      current texture coordinates
  17.  
  18.  
  19. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  20.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111dddd( GLdouble _s )
  21.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ffff( GLfloat _s )
  22.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111iiii( GLint _s )
  23.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ssss( GLshort _s )
  24.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222dddd( GLdouble _s,
  25.                         GLdouble _t )
  26.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ffff( GLfloat _s,
  27.                         GLfloat _t )
  28.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222iiii( GLint _s,
  29.                         GLint _t )
  30.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ssss( GLshort _s,
  31.                         GLshort _t )
  32.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333dddd( GLdouble _s,
  33.                         GLdouble _t,
  34.                         GLdouble _r )
  35.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ffff( GLfloat _s,
  36.                         GLfloat _t,
  37.                         GLfloat _r )
  38.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333iiii( GLint _s,
  39.                         GLint _t,
  40.                         GLint _r )
  41.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ssss( GLshort _s,
  42.                         GLshort _t,
  43.                         GLshort _r )
  44.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444dddd( GLdouble _s,
  45.                         GLdouble _t,
  46.                         GLdouble _r,
  47.                         GLdouble _q )
  48.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ffff( GLfloat _s,
  49.                         GLfloat _t,
  50.                         GLfloat _r,
  51.                         GLfloat _q )
  52.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444iiii( GLint _s,
  53.                         GLint _t,
  54.                         GLint _r,
  55.                         GLint _q )
  56.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ssss( GLshort _s,
  57.                         GLshort _t,
  58.                         GLshort _r,
  59.                         GLshort _q )
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))
  71.  
  72.  
  73.  
  74. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  75.      _s, _t, _r, _q
  76.               Specify _s, _t, _r, and _q  texture coordinates.  Not all parameters
  77.               are present in all forms of the command.
  78.  
  79. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  80.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ddddvvvv( const GLdouble *_v )
  81.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ffffvvvv( const GLfloat *_v )
  82.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111iiiivvvv( const GLint *_v )
  83.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ssssvvvv( const GLshort *_v )
  84.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ddddvvvv( const GLdouble *_v )
  85.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ffffvvvv( const GLfloat *_v )
  86.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222iiiivvvv( const GLint *_v )
  87.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ssssvvvv( const GLshort *_v )
  88.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ddddvvvv( const GLdouble *_v )
  89.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ffffvvvv( const GLfloat *_v )
  90.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333iiiivvvv( const GLint *_v )
  91.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ssssvvvv( const GLshort *_v )
  92.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ddddvvvv( const GLdouble *_v )
  93.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ffffvvvv( const GLfloat *_v )
  94.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444iiiivvvv( const GLint *_v )
  95.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ssssvvvv( const GLshort *_v )
  96.  
  97.  
  98. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  99.      _v    Specifies a pointer to an array of one, two, three, or four
  100.           elements, which in turn specify the _s, _t, _r, and _q texture
  101.           coordinates.
  102.  
  103. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  104.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd specifies texture coordinates in one, two, three, or four
  105.      dimensions. ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111 sets the current texture coordinates to (_s, 0, 0,
  106.      1); a call to ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222 sets them to (_s, _t, 0, 1).  Similarly,
  107.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333 specifies the texture coordinates as (_s, _t, _r, 1), and
  108.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444 defines all four components explicitly as (_s, _t, _r, _q).
  109.  
  110.      The current texture coordinates are part of the data that is associated
  111.      with each vertex and with the current raster position. Initially, the
  112.      values for _s, _t, _r, and _q are (0, 0, 0, 1).
  113.  
  114. NNNNOOOOTTTTEEEESSSS
  115.      The current texture coordinates can be updated at any time.  In
  116.      particular, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd can be called between a call to ggggllllBBBBeeeeggggiiiinnnn and the
  117.      corresponding call to ggggllllEEEEnnnndddd.
  118.  
  119.  
  120. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  121.      On OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems, use of the texture q coordinate to achieve
  122.      projective texture effects will be processed on a per-vertex basis
  123.      instead of a per-pixel basis, unless the texture matrix is set up to be
  124.      projective.  (A projective texture matrix, specified as 16-element array
  125.      M, is defined to be one in which any of the M[3], M[7], or M[11] array
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      elements is non-zero.) In addition, if either two-sided lighting or
  141.      fragment lighting or separate specular lighting is in effect, projective
  142.      texture effects will always be processed on a per-vertex basis.
  143.  
  144.  
  145. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  146.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDDSSSS
  147.  
  148. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  149.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ggggllllVVVVeeeerrrrtttteeeexxxx
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.